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L'UNICA RIVISTA PI SCRITTA DALLA COMUNITÀ RASPBERRY PI 




REALIZZA IL TUO 

SPECCHIO 

MAGICO 

Vivi il futuro con lo specchio connesso in rete, uscito direttamente dalla fantascienza 


t iviamo in un mondo in cui molti oggetti 

stanno diventando parte dell'IOT (Internet 
delle Cose). Frigoriferi che inviano mail perché 
il latte. Lavatrici che ti avvisano via Twitter 
quando il lavaggio è finito. Un’applicazione sullo 
smartphone per accendere le luci. Molte di queste cose 
possono apparire effimere, però; e probabilmente è 
questo il motivo per cui il concetto del Magic Mirror, 


ha avuto tanto seguito nella comunità dei maker: 
mostrarti le informazioni utili mentre ti specchi 
prima di uscire di casa. Uno strumento passivo ed 
utile. Michael Teeuw ha portato per primo il concetto 
sul Raspberry Pi rendendone facile la realizzazione a 
chiunque. Tutto quello di cui hai bisogno per 
costruirne uno è un po’ di tempo libero ed una sega 
affilata. 



IL 

PROCESSO 

I PASSI PER 
COSTRUIRE 
UNO SPECCHIO 
MAGICO 



OTTIENI I PEZZI 

Tutto quei che ti serve 
per realizzare iL tuo 
specchio personalizzato 


MONTA LO SPECCHIO 


Come mettere assieme la cornice 
e L'elettronica 
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Quel che ti serve per 
realizzare il 
tuo specchio 


COMPONENTI 


MATERIALI 

DI COSTRUZIONE 


LEGNO PER IL FRONTALE 

La parte anteriore si può realizzare con 
Legno per battiscopa o modanatura - 
assicurati che sia più largo del legno che 
utilizzerai per La cornice in modo che 
riesca a contenere tutto. 


CHIODI 

Li useremo per fissare il frontale; 
i5-20mm dovrebbero essere 
sufficienti. 


LEGNO PER LA CORNICE 

Il compensato è una buona 
scelta. Se non sei proprio alle 
prime armi con La falegnameria 
potresti tuttavia usare del pino o 
altri materiali. Assicurati che sia 
robusto ed abbastanza spesso 
per contenere tutta l’elettronica 
che serve - dai un occhiata ai 
passi per costruirlo per farti un 
idea delle misure necessarie. 


Servono alcune viti da Legno per 
costruire la cornice. Non devono 
essere enormi, basta che siano 20mm 
più Lunghe dello spessore del legno. 


WOOD 

GLUE 


VERNICE E SIGILLANTE 

Di sicuro vorrai che la cornice 
abbia un bell’aspetto, quindi 
usa del turapori o stucco per 
renderlo più liscio ed della 
vernice per completarlo. Se ti 
piace il legno che hai scelto 
puoi utilizzare del mordente. 


FALSO SPECCHIO 


COLLA 

PER IL LEGNO 

La useremo per tenere insieme tutti 
pezzi. Considerala un’aggiunta di 
sicurezza alle viti. 


Comprane uno della stessa 
misura del monitor, che sarà 
anche la misura della cornice. 
Ne puoi trovare anche fatti di 
acrilico. 
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REALIZZA IL TUO SPECCHIO MAGICO 


Teature 




ATTREZZI 

Ti servirà una sega, un 
martello, un trapano, alcuni 
morsetti e diversi strumenti 
da pittura, per questo 
progetto. Recuperali e tienili 
pronti. 
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ELETTRONIC 
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MON TOR/TELEV SORE 


Un generoso monitor o un vecchio 
televisore LCD dovrebbero essere 
perfetti per questo. Più Leggero è, e 
meglio è, però. Puoi decidere di 
L rimuovere il contenitore esterno 
del monitor, se è possibile, per 
risparmiare spazio e peso. 


RASPBERRY PI 


Naturalmente ne servirà uno da 
collegare al televisore. Un case (e un 
dognle WiFi se userai un Raspberry 
Pi2 o precedenti) dovrebbe 
contribuire a rendere il tutto un po' 
più ordinato e sicuro. 


CAV 


Ti serviranno 1 cavi di alimentazione 
per il monitor e il Raspberry Pi, e 
naturalmente il cavo HDMI per 
l'uscita video. 










MISURARE 
IL MONITOR 


Prendi le misure dello schermo. Anche lo spessore 
è importante per assicurarti che il legno scelto 
vada bene; è preferibile avere un piccolo spazio tra 
il monitor ed il muro, quindi assicurati che lo 
spessore del legno lo permetta. 



La cornice di base è costituita 
da quattro pezzi di legno, i due 
lati e le fasce sopra e sotto. I 
lati saranno un po più lunghi 
degli altri in modo che lo 
specchio sia in posizione 
verticale. I lati devono avere la 
stessa lunghezza del lato lungo 
dello schermo, mentre le fasce 
sopra e sotto devono essere 
lunghe come il lato corto più lo 
spessore del legno in modo che 
possano essere uniti 
comodamente a formare un 
rettangolo. Cerca di non 
realizzare lo spazio per il 
monitor troppo stretto - lascia 
un millimetro o due extra. 


© Larghezza dei monitor 
+ spessore dei Legno * 2 


© 


Altezza del monitor 


RICORDA: 


MISURA DUE VOLTE, 
TAGLIA UNA VOLTA SOLA 


PASSO 03: 


ASSEMBLARE 
LA CORNICE 


Questa è la cornice principale, quindi è meglio 
realizzarla il più robusta possibile. Avvitare il 
legno con due viti la renderà bella e solida, ma 
aggiungi un po' di colla da legno sarà per rendere 
la giunzione ancora più salda. 
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PASSO 04: 


PASSO 05: 


FISSA IL 
FRONTALE 


Con attenzione, inchioda i pezzi frontali, 
facendo attenzione che siano a filo con il 
bordo esterno. Usa prima un chiodo a 
ogni estremità, per essere certo che sia 
orientato correttamente (non inchiodarlo 
tutto fino a che non sei sicuro), o usa dei 
morsetti per serrarli tutti assieme. Una 
volta posizionati un paio di pezzi, con gli 
altri due sarà molto più facile. 


Febbraio 2017 


TAGLIA IL 
FRONTALE 

Una volta realizzato il telaio principale, possiamo 
aggiunge la parte frontale della cornice. Ha due 
funzioni: è smussata sul monitor rendendolo un po' 
più bello esteticamente, e fa da profilo per per 
contenere il monitor e lo specchio in posizione. 
Assicurati che il legno sia più ampio di quello usato 
per il telaio, proprio per creare questo profilo, e taglia 
le estremità ad angolo per quando li unirai tradoro. 






PASSO 07: 


i VERNICIATURA 

■ ; 


In questo esempio, il telaio viene verniciato di bianco con 
una vernice per legno. Fallo in un locale ben areato. 


Teature 




i: 


! PARTI FINALI 


LEVIGARE 


Utilizza un po' di stucco per appianare ogni 
avvallamento, comprese le teste dei chiodi sulla 
parte frontale. Poi leviga, per appianare tutto e 
preparare il legno per la verniciatura. 


Col trapano, realizza qualche foro sulla parte 
superiore e inferiore del telaio, come mostrato - 
servono per favorire la ventilazione. Non ci verrà 
tostato niente all'nterno, ma è meglio avere dell'aria 
che ci passa attraverso. Ti sarà utile montare anche 
una traversa, come mostrato, con delle scanalature 
per appendere il tutto a delle viti a tassello nella 
parete. Dovresti fare una piccola scanalatura sul 
retro del listello inferiore per far giungere i cavi di 
alimentazione fino al monitor e al Pi. Infine, crea 
delle piccole staffe, che puoi fissare al telaio per 
mantenere in posizione il monitor, evitando che 
cada dalla parte posteriore. 


pt 


P 


STUCCARE E 


PASSO 06: 





L 


REALIZZA IL TUO SPECCHIO MAGICO 


Teature 




PASSO 09: 


Quando la vernice è asciutta, ribalta la cornice in # 
modo che appoggi sulla parte frontale e con 
attenzione posaci dentro lo specchio. Lo terremo ifl 
posizione utilizzando la sporgenza della modanatura* 
frontale e il monitor, creando a tutti gli effetti un 
sandwich in cui lo specchio fa la parte del prosciutto . * 


PASSO 10: 


INSTALLARE 

L'ELETTRONICA 

Questa parte è abbastanza semplice: basta metterei 
il monitor sul retro, fissarlo con le piccole staffe in 
legno, e collegare il Raspberry Pi a Ila HDMI. Posa i 
cavi di alimentazione nella apposita scanalatura 
che hai creato.® 


UN CAVO, 

DUE DISPOSITIVI 


Una cosa che il creatore maker più esperto potrebbe fare è 
abbinare il cavo di alimentazione del televisore con un 
alimentatore USB. In questo modo, avrai bisogno di far 
passare attraverso lo specchio un solo cavo. 


INSERIRE • . 
LO SPECCHIO ’• 
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PROGRAMMA %o 

SPECCHIO 


Installa il software sul tuo Raspberry Pi e rendi il tuo specchio assolutamente magico 


t na volta appeso lo specchio al muro, o in 
qualsiasi altro posto ad esso destinato, è 
arrivato il momento di installare il software. 
1 ha reso il processo molto semplice, e tutto 
quello di cui hai bisogno è digitare questi comandi: 


curi -sL http://magpi.cc/MirrorInstall [ bash 


Procederà col processo di installazione e la definizione 
dei defaults ... ed ecco fatto! Lo specchio è pronto. 

PERSONALIZZAZIONE 

Bene, siamo quasi pronti: dai uno sguardo alle 
impostazioni predefinite per essere sicuro che tutto 
funzioni come desideri. Le impostazioni sono 
registrate in un file di configurazione che puoi 
creare così: 

cp ~/MagicMirror/conf ig/conf ig . js . sample 
~/MagicMir ror/conf ig/conf ig. js 

Adesso puoi aprilo e modificarlo con: 

nano ~/MagicMirror/conf ig/conf ig . j s 


Queste sono alcune opzioni che puoi modificare... 



# 


4 




M 


IL file di configurazione di esempio ti consente 
di iniziare, ma ce molto altro che puoi fare 


OPZIONE 

DESCRIZIONE 

port 

La porta utilizzata dal server MagicMirror. Quella 
predefinita è la 8080. 

address 

L’indirizzo IP dello specchio, lo useri per collegarti. 

1 ipWhitelist 

La lista degli IP autorizzati ad accedere allo 
specchio. Il valore predefinito: ["127.0.0.1" , 

" : : f f f f : 127 . 0 . 0 . 1 " , " : : 1 " ] . Si può 
definire indirizzo e maschera di sottorete: 

(["127.0.0.1", "127.0.0.1/24"] oppure un 
intervallo di indirizzi IP ( [ " 127 . 0 . 0 . 1 " , 

[ "192 .168.0.1"," 192 .168.0.100"]]). 

zoom 

Il fattore di zoom che determina la dimensione 
dell’interfaccia utilizza. Il valore di default è 1.0 

language 

La lingua dell’interfaccia. I valori possibili sono 
en, ni, ru, fr, e così via, ma il predefinito è en. 

timeFormat 

Il formato orario. I valori possibili sono 12 0 24. 

Il predefinito è 24. 

units 

Le unità di misura utilizzate per il meteo. I valori 
possibili sono metrico decimale 0 imperiale. Il 
predefinito è metrico decimale. 

modules 

Un elenco di moduli attivi. Ce ne deve sempre 
essere almeno uno attivo. 

electronOptions 

Una serie di opzioni per Electron (il browser). 

Questo permette di impostare ad esempio la 
dimensione e la posizione della finestra del 
browser (predefinito .width = 800e.height = 
600). La modalità chiosco si può impostare 
inserendo .kiosk = true, .autoHideMenuBar = 
false, .fullscreen = false. 
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REALIZZA IL TUO SPECCHIO MAGICO 


Teature 


DATA 


Che ore sono e che 
giorno siamo? 
Meglio smettere di 
ammirare il tuo 
riflesso o farai tardi 
al lavoro! 


TEMPERATURA 

Come il tempo? Farà bello oggi? O ce 
tempo da ombrello? Meglio che rientri 
prima del tramonto 


CALENDARIO 


Oggi è festa? Si sta 
avvicinando una 
riunione? Questo 
colore si cravatta è 
adatto per la 
riunione? 


M 


CARINERIE 

Grazie specchio, non 
sei niente male 
nemmeno tu! I miei 
complimenti alla 
fantaztica persona 
che ti ha realizzato 


• NEWS 

Qualche notizia 


importante che 
richiede La tua 
attenzione? 
Come è il 
traffico? Oh, 
guarda: rifanno 
in tv il mio 
show preferito! 
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Tmture 


PERSONALIZZA tuo 



Rendi il tuo specchio veramente tuo, aggiungendo e personalizzando moduli 


O ltre a quelli predefiniti puoi installare moduli di 
terze parti creati dalla comunità o da te. Sono 
facili da aggiungere: devi solamente scaricare i 
file e modificare la configurazione perché vengano 
utilizzati. 

Prima di tutto dai un occhiata ai moduli nella pagina 
del repository GitHub di MagicMirror qui: 
magpi.cc/2iqWPUh.. Troverai una lista di ottimi moduli 
da installare, come il modulo per monitorare i Bitcoin o 
la vignetta del giorno da XKCD. Scegline uno che ti 
interessa e copia il link. 

Per installare il modulo, prima spostati nella cartella 

modules con cd - /MagicMirror /modules scarica i file 
necessari col comando: 


OPZIONE 


module 


position 


git clone https ://github.com/[author]/ 
[module-name] 


...usando il link di GitHub che hai copiato 
prima. Controlla il file readme del modulo 
per verificare se ci sono delle altre operazioni 
da fare, in caso contrario, prima apri il file 
config.js, e poi aggiungi il nuovo modulo nella 
sezione dei moduli. Devi formattare il testo come in 
questo esempio: 


non vuoi 
SMANTELLARE 
■ L TUO SPECCHIO? 

: Usa SSH da un altra 

computer pe/° 
accedere al p/ 


DESCRIZIONE 



{ 


module: 'module name', 
position: 'position ' , 
header: 'optional header', 
config: { 

extra option: 'value' 

} 


h 


Qui accanto c’è l’elenco completo dei parametri 
utilizzabili... 


Il nome del modulo. Può contenere anche la 
sottocartella. Ecco alcuni validi esempi clock, 
default/calendar, e modules/[module name]. 

La posizione del modulo nello specchio. 

Alcuni possibili valori sono: 

top_bar, top_left, top_center, 
top_right, upper_third, middle_center, 
lower_third, bottom_lef, bottom_center, 
bottom_right, bottom_bar, 
fullscreen_above, e fullscreen_below. 

Questo campo è opzionale, ma molti moduli 
richiedono che venga impostato. Controlla la 
documentazione del modulo per maggiori 
informazioni. Più moduli configurati con la 
stessa posizione vengono visualizzati secondo 
l’ordine del file di configurazione. E' necessario 
fare un po' di prove. 



; 

1 

classes 

Classi aggiuntive che vengono passate al 
modulo. Campo facoltativo. 

header 

Per mostrare del testo introduttivo prima del 
modulo aggiungi questo campo opzionale. 

disabled 

Disabilita la creazione del modulo. Campo 
facoltativo. 

config 

Un oggetto con la configurazione del modulo. 
Controlla la documentazione del modulo per 
maggiori informazioni. Questo campo è 
facoltativo a meno che il modulo non richieda 
delle configurazioni aggiuntive. 
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j SUPPORTO & 
KCOMMUNITY 

r# . 

Hai realizzato il tuo specchio, ora 
qui trovi alcuni modi per seguire il 
. * suo sviluppo 




SITO MAGICMIRROR 

magicmirror.builders 

La prima tappa per le informazioni sullo specchio 
magico (MagicMirror) è la home page del software. 
Ci troverai diversi link a portata di mano, come 
quelli per il blog per gli aggiornamenti sul progetto, 
GitHub per il codice sorgente e le opzioni di 
configurazione avanzata dello specchio, così come il 
link al forum e ai moduli disponibili. È anche un 
buon modo per introdurre rapidamente un amico a 
questo progetto. 


FORUM SUL MAGICMIRROR 

magpi.CC/2je2dXI 

La Community del MagicMirror vive qui, e le risposte 
a molti dei problemi che a lungo termine ti potresti 
trovare a dover affrontare, qui probabilmente hanno 
già trovato risposta. Sono un gruppo amichevole, tosto, 
quindi se non ti è possibile trovare una soluzione, puoi 
sempre fare una chiacchierata con loro per trovare 
che cosa potrebbe essere andato storto. Potrai anche 
essere in grado di confrontare le note su eventuali 
moduli che deciderai di creare, 0 qualsiasi altro piccolo 
aggiornamento 0 suggerimenti di costruzione potresti 
desiderare di conoscere. 
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MAGICMIRROR MODULE 
DEVELOPMENT DOCUMENTATION 

magpi.cc/2jebu 

Sogni di creare il tuo modulo personalizzato per il 
tuo specchio? Avrai bisogno di conoscere come 
funzionano le API e il codice, e lo puoi fare con la 
documentazione fornita sul repository GitHub di 
MagicMirror. Abbiamo visto alcuni ottimi add-on 
per il codice, comprese le variazioni stagionali e gli 
orari dei treni in tempo reale. Tutto quel che ti serve 
è una fonte da cui ottenere i dati! 
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MagicMirror 2 Module Development Documentation 

Thls documem detsribes thè way ia dev&lcp your own F/agkMIrror 1 mcdules. 

Module strutture 
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Tutorial raspberry pi 101 


PASSA ALLA 


COMMAND LINE 

Utilizzando la Linea di Comando, puoi lavorare meglio e più velocemente. 

Scopri oggi come puoi cominciare... 



meno che tu non sia cresciuto nel 1980 o anche 
prima, con tutta probabilità sei abituato a usare 
solo le GUI (graphical user interfaces, 
interfacce grafiche utente) e gli ambienti desktop. 

In realtà non c'è nulla di male nelle GUI, e Raspbian 
ne possiede una particolarmente piacevole chiamata 
PIXEL. 

Ma al di sotto alle icone esiste tutto un altro mondo: 
la linea di comando. È lì che c'è il tuo vero computer. 
Con la linea di comando, non sei limitato a fare quello 
che le applicazioni desktop ti consentono di fare. Puoi 
fare qualsiasi cosa sul tuo computer, e farlo molto più 
velocemente. 

Pensa sia come guidare una macchina. Se hai sempre 
e solo usato la GUI, allora stai guidando col cambio 
automatico. La linea di comando è come passare al 
cambio manuale. È molto più complicato, ma ottieni 
molto più controllo e senti di guidare in modo più 
autentico. 


Clicca sulPicona del Terminale in alto nella barra 
dei menu (0 seleziona Menu > Accessories > 
Terminal). Si apre una finestra con lo sfondo nero e 
del testo verde e blu. Vedrai il prompt dei comandi: 

pi@raspberrypi:~ $ 

Ora sei nella linea di comando. Immetti i comandi 
utilizzando una interfaccia testuale. Digita echo 
Ciao Mondo e premi RETURN, vedrai ‘Ciao Mondo 1 
apparire. Sotto, vedrai ancora il prompt $, pronto ad 
accettare un altro comando. 

Molti utenti accedono alla linea di comando tramite 
il Terminale, ma c’è un altro modo, conosciuto come 
“console virtuale”. Premi CTRL + ALT +Fi e il 
desktop sparirà. Apparirà invece uno schermo nero, 
che mostrerà la scritta 'Raspbian 0 (Debian) 



GNU/Linux 8 raspberry pi tty’ e sotto di essa, 
‘raspberrypi login’.Se tu non sei automaticamente 
loggato, immetti pi e premi RETURN , poi inserisci la 
tua password ( raspberry è quella di default). 

Ora puoi usare la linea di comando tutto schermo. 
Puoi ritornare alla schermata di PIXEL, utilizzando 
CTRL + ALT +F7 e poi tornare alla console virtuale 
usando CTRL+ALT+Fi. Console virtuali aggiuntive 
potranno essere aperte usando CTRL+ALT+F 2, fino a 
F6. Ognuna di esse ha il proprio login e opera in 
modo indipendente. 

Se preferisci la linea di comando, puoi avviare 
direttamente Raspbian con essa, invece che con il 
desktop PIXEL. Apri Raspberry Pi configuration 
(Menu > Preferences > Raspberry Pi configuration). 
Modifica l’impostazione di avvio a “To CLI” e clicca 
OK . Ora, una volta riavviato, partirà dalla linea di 
comando (scrivi startx per avviare il desktop di 
PIXEL) 


La linea di comando uò essere scoraggiante per i 
nuovi arrivati, ma in realtà non è così. Con pochi 
comandi, la potrai padroneggiare. 


Scrivere i comandi 

Quando avvìi un Raspberry Pi, automaticamente ti 
ritrovi all’interno dell’interfaccia desktop PIXEL. 

Il modo più veloce per avere’accesso alla linea di 
comando è attraverso il Terminale. 


Molte persone 
accedono alla 
linea di comando 
attraverso il 
^ Terminale sul 
Vfesktop PIXEL 


Individua dove sei 

La prima cosa che hai bisogno di imparare è come 
scoprire dove sei. DI default, sei nella tua cartella 
home. Scrivi il seguente comando e premi RETURN 
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pi@ 

La prima parte della linea di 
comando è il tuo nome 
utente, seguito dal simbolo 
d>. Puoi verificarlo sulla 
linea di comando, 
immettendo whoami. 

raspberrypi 

Dopo la @, arriva il tuo host 
name. Che è il nome del 
tuo computer: 'raspberrypi' 
è il nome di default. 

~/Documents 

Dopo l'host name è 
presente la directory di 
lavoro corrente. Viene 
mostrato semplicemente 
'-' quando sei nella tua 
directory home. 


IL simbolo del Dollaro, 
indica che stai 
operando come 
normale utente. 


Questo comando è 1’ abbreviazione di “print 
working directory” (stampa directory di lavoro) e ti 
dice dove sei. La linea di comando restituirà 

/home/pi. 

La cartella home è la stessa che appare di default 
quando apri l’applicazione File Manager. È possibile 
visualizzare i file e le directory all’interno della 
cartella di lavoro, usando il comando list (ls): 


CAPIRE 

IL LINGUAGGIO 

Ce molta confusione relativa al gergo che ruota 
attorno alla linea di comando. Termini come linea di 
comando, Shell, e terminale sono spesso usati come 
sinonimi. 

Ognuno ha un significato preciso... 


ls 

Così vedrai le stesse directory (o cartelle) che vedi 
in File Manager: Desktop , Downloads , Documents , e 
così via. 


Il percorso del file 

Prima di proseguire nelle directory, è necessario 
comprendere il percorso del file e la differenza tra un 
percorso 'relativo 1 e 'assoluto'. 

I file vengono collocati nelle cartelle (che sono 
chiamate 'directory' nella linea di comando). Nelle 
GUI visuali, puoi vederle come cartelle, e aprendole 
rivelano altri file e cartelle. La tua home directory 
contiene una directory Documents, e al suo interno ci 
sono altre tre directory: Blue J Projects , Greenfoot 
Projects, e Scratch Projects. 

/home/pi/Documents/Scratch\ Projects 


> TERMINALE: Questo è il programma che utilizzi per 
accedere alla Linea di comando dal desktop PIXEL in 
Raspbian (il suo nome completo è LXTerminal). 


> CONSOLE: Questo è lo schermo terminale con tastiera 
fisico. E’ una specie di computer vuoto, utilizzato per 
connettersi a grandi computer mainframe. 


> CONSOLE VIRTUALE: Queste sono le versioni virtuali di 
una console fisica. In Linux, si dispone di console 
virtuali multiple accessibili tramite i tasti CTRL+ALT e i 
tasti funzione. 

> TTY: Teletypewriter. In Linux, tty è usato per 
mostrare quale console virtuale stai utilizzando: ttyi, 
tty2, e così via. 

> LINEA DI COMANDO: Questo è l'ambiente testuale in 
generale o la riga specifica su cui stai lavorando. La 
linea di comando inizia con il segno del dollaro ($), 
conosciuto come ’prompt’. 


Nel percorso del file qui sopra, la prima barra è la 
radice del tuo disco fisso. Qui hai la directory chiamata 
home, che contiene tutti gli utenti. Dentro di essa c'è 
un’altra directory chiamata pi (che sei tu), e dentro 
questa c'è un'altra directory chiamata Documents , che 
a sua volta contiene quella chiamata Scratch Projects . 

Il vostro occhio di falco avrà senz'altro notato una 
strana barra al contrario (backslash: ‘\’) . Non puoi 
avere avere spazi nei nomi dei file, così, utilizzi un 
backslash seguito da uno spazio, all'interno della 


SHELL: È un’interprete della linea di comando. 
Circonda il Kernel del computer (da qui il nome shell: 
conchiglia). Per arrivare al Kernel, si passa attraverso 
la Shell. Essa interpreta i tuoi comandi testuali e li 
trasforma in codice che il Kernel possa capire. 


BASH: Sta per ‘Bourne Again Shell’ ed è un tipo di 
shell utilizzato da Debian (la versione di Linux su cui è 
basato Raspbian). 
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ls 

La prima parte del 
comando è il 
comando stesso. 

Qui abbiamo ls, che 
elenca il contenuto 
di una directory 

-lah 

Dopo il comando, 
vengono le opzioni, 
cominciano con un 
trattino e sono 
tipicamente singole 
lettere. Ognuna 
modifica il comando. 
Qui abbiamo T, ‘a’ e 'h\ 
Stanno per la modalità 
lunga, tutti i file, e in 
formato più leggibile. 


039 

Pm 6*1 Tite t^ F i 


pi@raspberrypi: ~ $ ls -lah /home/pi/Documents/ 
total 20K 

drwxr-xr-x 5 pi pi 4.0K Dee 15 14:37 . 

drwxr-xr-x 31 pi pi 4.0K Dee 15 12:52 .. 

-rw-r--r-- 1 pi pi 0 Dee 15 14:37 a_file.txt 

drwxr-xr-x 11 pi pi 4.0K Nov 25 17:49 BlueJ Projects 

drwxr-xr-x 5 pi pi 4.0K Nov 25 17:49 Greenfoot Projects 

drwxr-xr-x 2 pi pi 4.0K Nov 25 17:46 Scratch Projects 

pi@raspberrypi: - $ | 




/home/pi/ 

Documents 

La parte finale del 
comando è l’argomento. 
Spesso è un nome di file 

0 un percorso. Qui stiamo 
listando un percorso 
assoluto (percorso 
diretto alla directory 
Documents). Se ometti 
l’argomento, visualizzerà 

1 contenuti della 
directory corrente. 


Digita: 

ls / 

...per visualizzare la directory principale (root). 
Qui vedrai tutte le directory e i file che 
compongono Linux. Vedrai directory come bin 
(per i binari), boot (file usati per avviare il 
sistema), e home, che contiene la tua cartella 
utente. 

Digita: 

Puoi vedere il contenuto della directory al livello ls / h0me /pi 

superiore utilizzando due punti (..): 

...e vedrai il contenuto della tua cartella home, 

ls • • proprio come se tu avessi digitato ls alPinterno di 

essa. 

Questo comando visualizza i file relativi al punto in Puoi utilizzare i percorsi assoluti senza che 
cui ti trovi nel file System. Se ti sei spostato nella importi quale sia la tua directory corrente, perché 

cartella Downloads e poi hai digitato ls Documents, essi partono sempre dalla radice, 
otterrai un errore, perché non ci sono directory 

Documents alPinterno della cartella Downloads. Muoversi attorno 

Un percorso assoluto, d’altra parte, inizia sempre Fino ad ora siamo rimasti neUa cartella home e 

con una slash / che e la directory principale, la abbiamo datQ un . occhiata intorno usando ls . Ti 

radice (la base del tuo disco fisso). sei mosso da una directory a un’altra usando u 

comando cd (change directory): 

cd Documents 


Ora digita: 

pwd 


...vedrai un differente percorso di lavoro: 
/home/pi/Documents. Per tornare indietro di 
una directory (conosciuta come directory 'padre 1 ), 
usa due punti. 

cd . . 


La linea di comando 









può essere usata per 
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linea di comando. La maggior parte delle volte puoi 
usare tasto TAB per completare rapidamente nomi di 
file lunghi (vedi completamento TAEP). 

Come già detto, i percorsi dei file sono di due tipi: 
relativo e assoluto. I percorsi relativi sono ‘relativi’ 
alla tua directory di lavoro, che è /home/pi/ all'inizio. 
Se scrivi ls da solo, viene mostrato il contenuto della 
directory corrente. Puoi visualizzare il contenuto di 
una directory dentro la tua directory corrente usando 
ls e il suo nome: 


ls Documents 


4 D 


MàcfPi Febbraio 2017 


raspberrypi.org/magpi pagina tradotta da FLav per www.raspberryitaly.com 





LINEA DI COMANDO 


Tutorial 


Digita pwd ancora e tornerai nella cartella home. 

Ora prova ad usare un percorso assoluto. Digita: 

cd / 

...e sarai nella directory di root. Digita ls per vedere le 
cartelle alla base del tuo disco fisso. Immetti: 

cd /home/pi 

...per tornare alla cartella home. C’è una scorciatoia 
per questo: 

cd ~ 

Il carattere tilde (~) è una scorciatoia per arrivare alla 
cartella home. Lo puoi usare anche all’inizio di un 
percorso assoluto. Ad esempio digitando: 

cd ~/Downloads 

...ti sposti nella tua cartella Downloads, non ha 
importanza dove ti trovi nel sistema. 

File 

In tutto il filesystem troverai diversi tipi di file. Una 
bella selezione è nella cartella python_games, quindi 
digita: 

cd ~/python_games 
ls -1 

L’opzione -1 seleziona la modalità ‘lista lunga’, la 
quale permette di visualizzare molte informazioni 
aggiuntive per ogni oggetto: 

-rw-rw-r-- 1 pi pi 973 Dan 27 2015 
4row_arrow.png 

Da sinistra a destra, ogni oggetto è: 


> Permessi: 

Gli utenti e i gruppi che possono 
accedere ad un file. 

> Hard links: 

Il numero di file che sono linkati 
a questo file. 

> Proprietario: 

La persona che possiede il file. 

Di solito pi 0 root. 

> Gruppo : 

Il gruppo al quale il file appartiene. 

> File size : 

La dimensione del file. 

> Modifica: 

L’ultima volta che il file è stato 
modificato. 

> File name : 

Il nome del file. 


La parte più difficile da interpretare è la lista di 
lettere e trattini che costituiscono i permessi. 

La prima lettera sarà a oppure a ‘d’ a seconda se è 
un file o una directory. Il nostro 4 row_arrow.png è 
un file, quindi è un ‘- 1 . 

Dopo di quello ci sono 9 lettere divise in gruppi di tre 
(vedi Fig 1 sopra): 


>Proprietario : Di solito questa è la persona che ha V 

creato l’account. 

> Gruppo : Questo è un gruppo di utenti. C’è solo 

un gruppo di default, pi, che contiene 
solo un utente (anche questo pi). 

> Altri: Questi sono utenti di altri sistemi. 

Ogni gruppo contiene le lettere ‘rwx’. Queste lettere 
sono sempre in questo ordine e possono essere sia lettere 
che trattini. Una lettera indica che l’utente o il gruppo o 
altro ha accesso a leggere, scrivere 0 eseguire il file. Un 
trattino invece indica che non hanno quel livello di 
accesso. 

Alcuni esempi includono: 

> rwx legge, scrive, esegue 

> rw- legge, scrive, ma non esegue 
>r-x legge ed esegue 

>r-~ solo lettura 

Adesso che hai scoperto come muoverti all’interno 
della cartella di sistema dalla riga di comando, è tempo di 
imparare cosa altro puoi fare. 


Prendi il comando 

Uno dei primi comandi che hai bisogno di imparare è 
mkdir. Questo significa ‘make directory’ (crea directory). 
Spostati sulla cartella home e crea una directory chiamata 
test: 

cd ~ 

mkdir test 
cd test 



piflrasptoer rypi t rd pytti orbarne 5 / 

pi#raspberrypi. -Vpychon jjsuses 1 xdg-open Tree_ 

Tree_Short . png Tree_Tsll + png TreeJJgly «png 
p igra$pbe r ryp i > oy 1 1 . . - > xdg • ape n Tree _Ug 1 y , pn p, f 


COMPLETAMENTOCON TAB 

IL trucco più utile da imparare per La riga di comando è il 
completamento con il tab. Premendo TAB in qualsiasi 
momento quando stai digitando un percorso, questo 
verrà completato con il nome del file o della directory 
per te. Usa cd python_games e digita xdg-open Tr , 
poi premi iL pulsante TAB. Noterai che verrà completato 
con f xdg-open Tree_L Ci sono tre file che iniziano 
con Tree, premi velocemente due volte TAB per 
vederli: Tree_Short. png, Tree_Tall. png e 
T reeJJgly . png. Premi S, T, o U e poi premi ancora 
TAB per completare l'intero nome. Premi RETURN per 
aprirlo. 

Il completamento con TAB è preziosissimo quando 
digiti nomi lunghi con molte lettere, numeri e segni di 
punteggiatura. 
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Fig 1 La struttura dei 
permessi dei file 
o directory Unix. 
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Per creare file userai un commando piuttosto strano 
chiamato touch. Ufficialmente, touch viene usato per 
aggiornare Porario delPultima modifica di un file (lo 
raggiunge e lo ‘tocca 1 ). Se tocchi un file, Porario 
corrente sostituisce quello visualizzato 
precedentemente. 

Poche persone usano touch per quello, però. Un 
comodo effetto secondario di questo comando è che 
se tu tocchi un file che non esiste, in realtà crei un file 
vuoto. Digita: 

touch test.txt 


Puoi digitare e modificare il testo in nano ma i pulsanti 
Salva ed Esci differiscono dai tradizionali CTRL+S , e 
CTRL+W. Digita una linea singola, “Ciao Mondo!” e 
premi CTRL+O seguito da ENTER per salvare il file. Ora 
premi CTRL+X per uscire. 

Digita ls -1 ancora e noterai che la dimensione del file 
è cambiata da o a 12. Ogni lettera (spazio incluso) e 'a 
capo' alla fine (puoi vedere questo carattere con od -c 
test . txt se sei curioso), concorre alla dimensione. 

Ora proviamo a cancellare il file. Questo comando 
rimuove 
il file: 


Puoi impostare 
Raspbian aLL’avvio 
dalla riga di 
comando invece 
che dalla interfaccia 
grafica nelle 
impostazioni di 
configurazione. 


Creerai un file vuoto chiamato test.txt. Digita ls -1 
E vedrai il nuovo file con tutti i suoi dettagli. 

Nota che la dimensione del file è 0. Questo perché il 
file è completamente vuoto. 

Puoi modificare il contenuto del file usando un 
editore di testi chiamato nano: 

nano test.txt 


Raspberry Pi Configli rati on 


System 

Interfaces 

i — | 

Performance Localìsation 


Filesystem: 


Expand Fiiesystem 

Password: 


Change Password... 

Hostname: 


raspberrypi 

Boot: 


O To Desktop ® [To CU 


Auto Login: 


*6 Login as user 'pi' 

Network at Boot: 

Q Wait for network 

Splash Screen: 

O Enabled (£ Disabled 

Underscan: 


* Enabled O Disabled 


rm test.txt 

Ora spostati sulla directory padre e usa un altro 
comando, rmdir, per rimuovere la directory vuota test. 

cd . . 

rmdir test 

Sfortunatamente, utilizzerai raramente rmdir per 
rimuovere directory perché di solito hanno file al loro 
interno. Puoi vedere il messaggio di errore con questi 
comandi: 

mkdir test 

touch test/test_file.txt 

rmdir test 

Ti dirà rmdir: failed to remove 'test': Directory not 
empty. La soluzione è usare rm con Popzione -R. 
Questa opzione sta per ‘ricorsiva’ cioè entra in ogni 
directory e sottodirectory e rimuove ogni singolo file e 
directory. Fai attenzione quando usi rm -R, perché le 
modifiche sono permanenti e viene cancellato tutto 
quello che si trova alPinterno. Digita: 


La directory test e tutto il suo contenuto scomparirà. 
Diversamente dalPambiente desktop, nella riga di 
comando non esiste il Cestino. Quando rimuovi i file, 
questi saranno rimossi immediatamente e per sempre. 
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Opzioni 

Molti comandi hanno delle opzioni che modificano il 
loro modo di operare. È usuale usare queste tre opzioni 
con il comando ls: 

ls -lah 

Le opzioni iniziano con un singolo trattino ‘-’ 
seguito da una lettera per ogni opzione. Le tre opzioni 
usate sono: 

• 1 = formato lista dettagliata 

• a = tutti i file inclusi quelli nascosti 

• h = leggibile da umani (rende i file di grandi 
dimensioni ,più leggibili) 


Le opzioni tengono conto del maiuscolo o minuscolo. 
Quindi ls -1 e ls -L sono due cose diverse (T 
minuscola è per il formato lista dettagliata mentre ‘L’ 
maiuscola significa senza referenze). A volte le 
opzioni sono scritte in forma estesa. Queste iniziano 
con due trattini e hanno un trattino solo come 
spaziatore. Questo comando è lo stesso di ls -lah: 

ls -1 --all --human-readable 

Ma è più comune vedere (ed usare) le lettere singole. 


Sudo 

Sudo significa ‘utente sostituto fa’, anche se è spesso 
chiamato ‘superuser fa'. Se hai più di un utente può 
Essere usato per eseguire i comandi come se tu fossi 
un altro utente. 

È usato principalmente per ottenere accessi di root 
sul tuo sistema Linux. C’è un account che controlla il 
tuo utente Pi chiamato ‘root’. Questo è un account con 
tutti i permessi e può apportare qualsiasi modifica al 
tuo sistema. 

Il tuo account di default può vedere i file nella radice 
del tuo disco fisso, ma non può crearne di nuovi o 
cancellare quelli già esistenti. Digita: 

cd / 

touch test.txt 

Vedrai touch: cannot touch ‘test.txth Permission 
denied. Però, se digiti: 

sudo touch test.txt 

...viene creato il file test.txt nella root del tuo disco 
fisso. Puoi vederlo con ls -1. 

Ora prova ad eliminarlo: 

rm test.txt 

Ti dirà rm: remove write-protected regolar empty 
file ‘test.text’? Premi Y e ti dirà rm: cannot remove 
‘test.txt’: Permission denied. 

Dovrai usare sudo per rimuovere il file: 
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sudo rm test.txt 

È facile comprendere che sudo è uno strumento 
davvero potente. Senza di lui non potresti installare 
software usando apt o apt-get. Ma usandolo, puoi 
rimuovere o cancellare importanti file di sistema. 

Digita ls /bin e vedrai molti programmi (conosciuti ' t , 
come binari) usati da Linux. Questi includono anche il 
comando ls che hai appena usato. Cancellare per errore 
questi file potrebbe rendere II tuo sistema instabile. 

Quindi utilizza sudo con attenzione. In Raspbian non è 
necessario digitare la password per usare sudo. In molti V 
altri sistemi Linux ti verrà chiesta la password prima di 
poter utilizzare sudo. 

Che succede, man? 

Ci sono molti modi per chiedere aiuto tramite la linea di 
comando. Il primo a cui dovresti fare riferimento è man. 

Man sta per ‘manuale’ e ti fornisce le istruzioni per usare i 
comandi e gli strumenti di Linux. Digita: 

man ls 

...e vedrai il manuale per il comando list. 

Nota che sotto la SINOSSI dice: 

ls [OPTION]... [FILE]... 

Questo ti mostra la struttura del comando. 

Quasi tutti i comandi posseggono la struttura ‘comando, 
opzione, argomento’ anche se alcuni argomenti hanno più 
di un argomento [FILE] (come una copia, che richiede un 
file di origine ed uno di destinazione). 

Premi la barra spaziatrice per scorrere le istruzioni. 

Qui vedrai la lista di opzioni disponibili. 

Con man, puoi avere informazioni dettagliate su ogni 
strumento nella riga di comando. Puoi anche ottenere il 
manuale del comando man con: 

man man 

Se hai bisogno di un promemoria veloce su come utilizzare 
un comando, prova ad usarlo con - ho - -help come 
opzione: 

touch -help 

. . .ti dirà quali opzioni sono disponibili con il comando I 
touch. Puoi usarlo con molti comandi per rinfrescarti la M 
memoria velocemente su come utilizzarli. m 

Spostarsi dalla GUI alla riga di comando è un’abilità 
vitale per hacker e programmatori. Qualsiasi cosa 
nel tuo computer, da un programma alle preferenze, 
è memorizzata nel file System, da qualche parte. 

Imparare ad utilizzare la riga di comando ti rende 
un utilizzatore di Raspberry Pi più capace. 

Quindi la prossima volta che devi spostare un file o 
cancellare qualcosa non utilizzare il File Manager. 

Apri il terminale e compi l’operazione da riga di 
comando. Presto ti diventerà naturale. 
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Maneggia OOP usando Scratch e Python per creare gli stessi programmi 


COMPRENDERE 

LA PROGRAMMAZIONE 

ORIENTATA AGLI 

OGGETTI 
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Tentare 


COMPRENDERE LA PROGRAMMAZIONE ORIENTATA AGLI OGGETTI 



O el mondo moderno, quasi tutto il codice che 
incontrerai è scritto con uno stile chiamato 
‘object oriented programming’ 
(programmazione orientata agli oggetti) spesso 
abbreviato in OOP. 

Se sei cresciuto con l'OOP questo risulta di 
sicuro il modo più naturale per programmare 
un computer. 

Nel paradigma OOP il codice viene usato per 
creare oggetti; questi rappresentano oggetti 
reali del nostro mondo: un cane, una sedia o 
la ruota di un’auto. 

Gli oggetti contengono sia le caratteristiche 
di una data cosa: l’altezza, l’età ed il nome di 
una persona ad esempio; sia le operazioni che 
l’oggetto può compiere: un cane può saltare, 
camminare o correre; una ruota può girare. 

OOP combina le caratteristiche e le funzioni 
di un oggetto. In questo paradigma è molto 
facile portare il codice da un programma ad un 
altro. Non hai nemmeno bisogno di copiare ed 
incollare, basta usare le istruzioni per importare 
le funzioni e le variabili necessarie. 

Con la OOP non devi creare un oggetto ‘cane’: 
infatti basta che cerchi qualcuno che l’abbia già 
realizzato e importarlo nei tuoi programmi. 


Importare la conoscenza 

All’inizio di molti programmi trovi una serie di 
istruzioni per l’importazione. Queste sono utilizzate 
per includere il codice scritto da altre persone. 

Il paradigma OOP non è perfetto. A volte è 
considerato eccessivo. “Il problema con i linguaggi 
orientati agli oggetti è che si portano dietro un 
ambiente implicito”, dice Joe Armstrong, il creatore di 
Erlang. “Volevi una banana e ti ritrovi con un gorilla 
che regge una banana più tutto il resto della giungla.” 

Inoltre c’è tutto un lessico ornamentale che ruota 
attorno alla OOP. Incontrerai un sacco di strane parole 
come ‘incapsulamento’ ed ‘istanziazione’. Queste 
fanno sembrare il concetto più complesso di quanto 
non sia in realtà, e possono essere piuttosto 
scoraggianti per i principianti. 

Quindi la programmazione ad oggetti è piuttosto 
prolissa ed autocontemplativa. Molti maker, hacker e 
programmatori soffrono per comprendere la OOP 
anche se è possibile realizzare molte cose pur senza 
comprenderla. 

D’altro canto i giovani programmatori sono sempre 
più spesso iniziati alla programmazione attraverso 
Scratch. 

Scratch è incluso in Raspbian (ed in Debian con 
PIXEL) ed è stato creato per insegnare agli studenti la 
OOP, in modo trasparente. 

In Scratch gli oggetti si chiamano ‘Sprites’ ed 
assomigliano ai personaggi dei videogiochi. L’idea è 
che i bambini che crescono con Scratch si sentiranno 
più a loro agio con gli oggetti quando incominceranno 
ad utilizzare linguaggi come Python. 


OLTRE LA 

PROCEDURA 

Quando incomincerai a programmare, lo farai 
scrivendo codice procedurale. 

Nella buona vecchia programmazione 
procedurale di solito crei tutte le variabili all’inizio 
del programma. Poi definisci alcune funzioni (i 
blocchi di codice riutilizzabili). 

Abbiamo già dato uno sguardo alla 
programmazione procedurale nel numero 53 di The 
MagPi (magpi.cc/2Lin6PQ). 

OOP utilizza le basi della programmazione 
procedurale - variabili, funzioni, cicli, condizioni - ma 
li accorpa in blocchi di codice indipendenti 

Molti programmatori creano script procedurali che 
importano oggetti (da moduli o librerie). In questo 
modo usano gli oggetti senza nemmeno rendersene 
conto. 

I concetti della OOP si possono trovare quasi in 


tutti i moderni linguaggi di programmazione inclusi 


Python e Java. 
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Crea un gioco in Scratch dove i giocatori possono 
giocare a dadi tra loro 


Coùa 

Serve 


Raspbian 
con PIXEL 

> Un account 
Scratch 2.0 


© rima creeremo un gioco in Scratch, poi in 
seguito lori faremo con Python in 
modo che tu veda come funziona con 
entrambi i linguaggi. 

Il nostro gioco di dadi si basa su Bunco ( 
magpi.cc/ 2 h 0 ZNcj), un gioco di società popolare 
in Nord America. 

Abbiamo semplificato le regole. Ogni giocatore 
lancia tre dadi e conta i punti. Il giocatore col 
punteggio più alto vince. 

Abbiamo bisogno di due sprite (giocatori), 
ognuno col proprio set di dadi. Ogni giocatore 
lancia i dadi, controlla il punteggio e poi confronta 
i dadi con quelli delPawersario. 

Se i punteggi sono uguali entrambi dicono 
“pareggio”. Se uno dei due si accorge che il suo 
punteggio totale è più alto di quello dell’altro 
giocatore, allora griderà “Ho vinto!”. 

Questo gioco servirà ad introdurti al concetto di 
variabili locali. Ciascun giocatore avrà tre variabili: 
il rispettivo set di dadi. I giocatori possono anche 
vedere le variabili (o dadi) che sono locali per 
l’altro. 

L’opposto di una variabile locale è una variabile 
globale. Se usassimo una di queste sarebbe come se 
ciascun giocatore lanciasse lo stesso set di dadi e 
condividesse il risultato con l’altro. Sarebbe 
sempre pareggio. 

Scratch funziona in modo leggermente diverso da 
Python. In Scratch crei un personaggio con lo 
sprite e poi lo cloni (duplichi) per crearne un 
secondo. In Python tu crei un progetto per i tuoi 
personaggi (noto anche come ‘classe’) 0 poi 
costruisci due oggetti giocatore. Arriveremo a 
Python tra poco. 

Prima, creiamo il gioco di dadi con Scratch... 



>PASS0-01 

Scratch 

Apri il browser e visita il sito scratch.mit.edu per 
aprire Scratch 2.0. Ci serve la funzione clone della 
versione 2.0, quindi non utilizzare la versione 1.4 
dell’applicazione. Autenticati (oppure crea un account 
se sei nuovo in Scratch). Crea un nuovo progetto e 
vedrai lo sprite del gatto Scratch sullo schermo. Premi 
il simbolo T sull’icona in basso a sinistra. Cambia il 
nome in Playen. 


>PASS0-02 

Tre dadi 

Premi su Data e poi su Make a Variable. Digita dicei nel 
campo Name della variabile e seleziona l’opzione ‘For 
this sprite only’. Premi OK e dicei apparirà nella 
tavolozza dei blocchi. Ripeti il procedimento per creare 
dice2 e dice3. Infine crea un’altra variabile chiamata 
total. Ricordati di scegliere l’opzione ‘For this sprite 
only’ per tutti e tre i dadi e per il totale. 


BB 
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>PASS0-03 

Lanciare i dadi 

Clicca su Situazioni e trascina il blocco quando si 
clicca su bandiera verde nell'area dello script. 
Sotto a questo, devi aggiungere tre blocchi porta 
diceN a numero a caso tra 1 e 6. Sotto questi 
blocchi, aggiungi sporta totale a dicel + 
dice2 + dice3 (devi trascinare un blocco di 
addizione dentro l'altro per sommarli tutti e tre. 


quando si clicca 

- 1 


porta 

dicel 

a 

numero a 

caso tra 0 e 0 

porta 

dke2 

a 

numero a 

caso tra 0 e 0 I 

porta 

dkel 

a 

numero a 

caso tra *0 e 0 1 

porta 

tota 1 

a 

dicel +- 

dice 2 + dice 3 


>PASS0-04 

Parlare 

Adesso trascina un blocco dire per e attaccalo alla 
fine del codice. Modificalo in dire total per 1 
secondi. Sotto di esso, trascina un blocco se, dentro il 
quale, aggiungi un blocco [] > [] (maggiore di). 
Trascina la variabile total sul lato sinistro del blocco 
maggiore di. Trascina un blocco dire all'interno del 
blocco se e cambia ‘Hello!’ in ‘Ho vinto!'. 


quando si cficca su 


porta dicel a ninnerò a caso tra 0*0 

porta dee2 a numero a caso tra O«0 

porta dice] a numero a caso tra 0 e 0 

porta trtd a dicel -I- dice 2 + dkel 

dire total per 
se total > allora 



>PASS0-05 

Confrontare i punteggi 

Finora, abbiamo un solo sprite. Ma stiamo per 
aggiungerne un altro e confrontare il totale di uno 
sprite con l'altro. Scegli i blocchi Sensori, e cercane 
uno che si chiama posizione x di PlayerlQ 
Modifica 'posizione x' con total. Trascina poi il 
blocco dal lato corretto del blocco maggiore di. 



r >PASS0-06 

Secondo giocatore 

Il Tuo primo giocatore è pronto. Ora cloneremo lo sprite 
per creare il secondo giocatore. Tasto destro sullo sprite e 
scegli Duplica. Il nuovo sprite a forma di gatto, sarà 
automaticamente chiamato ‘Player2'. Clicca su Playen 
nella finestra degli sprite. Modifica il blocco total di 
Playerl in total di Player2 (come mostrato sotto). 
Ora il Playerl confronta il proprio totale con il Player2 (e il 
Player2 confronta il proprio con il Playerl). Clicca sulla 
bandierina verde per lanciare il programma e vedere chi 
vince. 


B4.ncs su Gcr*ai 


■ % 



AMBITO 


Il concetto di ambito è importante nella programmazione orientata agli 
oggetti. In Scratch, è così semplice che non te ne accorgi nemmeno. Ma i 
tuoi due giocatori hanno entrambi le loro variabili dicel, dice2 e dice3 più 
una total. Queste variabili sono in ambito locale. Quando il primo giocatore 
annuncia il totale, è il suo totale. Se entrambi gli sprite avessero accesso 
alla stessa total, sarebbe di ambito globale. Le Variabili negli oggetti sono 
in ambito locale. 
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CREA BUNCO 


IN PYTHON 


CLASSI 


Riscrivere il gioco Bunco in Python 


ED ISTANZE 

Una delle grandi differenze tra creare sprite in Scratch ed 
oggetti in Python è che gli oggetti vengono creati utilizzando 
una classe, che agisce da modello/progetto per l’oggetto. 

In Scratch crei gli sprite e poi li duplichi, e il secondo ha Le 
stesse funzioni del primo ed il suo proprio set di variabili. 

In Python (ed altri linguaggi di programmazione) Le cose 
funzionano in modo leggermente diverso. Non crei gli oggetti 
direttamente, ma un modello per gli oggetti, chiamato ‘classe’, 
che in questo caso, non ha niente a che vedere con la scuola. 
Indica invece una categoria di oggetti simili. La classe è 
piuttosto simile ad un pianeta di ‘Classe M’ in Star Trek: anche se 
diversi, questi pianeti sono tutti simili alla terra. 

Una volta creata La tua classe, la userai per creare gli oggetti, 
che vengono chiamati ‘istanze’ o ‘istanze oggetto’ e condividono 
proprietà simili; hanno Le stesse variabili e Le stesse funzioni 
(chiamate ‘metodi ). In Scratch crei uno sprite e poi lo duplichi 
(per ottenere due sprite). In Python crei una definizione di 
classe, che poi utilizzi per creare due istanze dell’oggetto. 


O a nostra semplice versione di Bunco gira bene 
in Scratch. Ora la ricreeremo in Python. 

La traduzione tra i due linguaggi ci aiuterà a 
capire bene come funzionano gli oggetti. 

Prima di tutto pensiamo a come realizzare il gioco in 
maniera procedurale. 

C’è un modulo chiamato random che possiamo 
utilizzare per generare numeri casuali; quindi 
dobbiamo importarlo. Poi possiamo creare una lista 
per ciascun giocatore ed usare la funzione randint per 
aggiungervi tre numeri casuali compresi tra uno e sei. 

Possiamo utilizzare un costrutto if else con la 
funzione sum() per sommare i numeri di ciascun 
giocatore e quello col punteggio più alto vincerà la 
partita. 

Digita il codice dal file bunco_procedural.py per 
provare il programma. 

Ci sono due problemi in questa procedura. Bunco è 
molto più complesso nel mondo reale. Si gioca in sei 
round ed i giocatori raggiungono i 21 punti solo nel 
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caso in cui lancino i dadi ed ottengano tre numeri 
uguali e corrispondenti al numero del round in corso 
(tre ‘1’ nel primo round, tre ‘2’ nel secondo e così 
via). Questo risultato è detto lanciare un ‘Bunco’. 

Noi non lo faremo così complesso, ma 
aggiungeremo un nuovo tipo di giocatori. Gli 
imbroglioni! Una canaglia ha lanciato i dadi; l’altro 
furfante ne cambia uno per ottenere un sei. 

Poi giocheremo migliaia di partite e vedremo chi 
sarà il vincitore. 

Nella programmazione procedurale ricreare questa 
complessità è estremamente difficile e richiede un 
cambio radicale nel nostro approccio a Bunco. La OOP 
è la risposta. 


bunar-proceduraLpy, 


import random 

playerl_dice = 
player2_dice = 


Teature 


lingua#^ 

> PYTHON 



SCARICA: 

magpi.cc/2jxE6WJ 



[] 

[] 


for i in range(3) : 

playerl_dice. a ppend( random. randin' (1,6)) 
player2_dice. append( random. randint (1, 6) ) 


I vantaggi della OOP 


Invece di creare all’inizio una lista di variabili per ogni 
giocatore, definiamo una classe chiamata Player. 

Il codice contenuto nel file bunco_oop.py 
rappresenta un giocatore che lancia i dadi. In seguito 

10 useremo per creare due giocatori (vedi ‘Classi ed 
Istanze 1 ). 

Iniziamo importando il modulo randint come nel 
nostro codice procedurale. 

Adesso proseguiamo definendo i nostri oggetti 
giocatore e per farlo creiamo una definizione di classe 
che appare così: 

class Player: 

All’interno della definizione della classe va identato 

11 codice che rappresenta l’oggetto giocatore. 

Nota bene che il nome della classe ha la lettera 

maiuscola e, rispetto alla definizione di una funzione, 
non usa le parentesi. 

La prima cosa che dobbiamo aggiungere è una lista 
che contenga i dadi. Normalmente è sufficiente 
scrivere dice = [], ma se la definissimo così... 


class Player: 
dice = [] 

...avremmo un problema. Questo codice equivale 
all’opzione ‘For all sprites’ presente in Scratch. Tutti i 
giocatori creati con questo codice condivideranno lo 
stesso gruppo di variabili ed otterranno lo stesso 
risultato, mentre noi vogliamo usare l’equivalente di 
‘For this sprite only’. 

Per assicurarci che tutti i nostri giocatori abbiano il 
loro proprio gruppo di variabili, dobbiamo racchiudere 
la lista dice = [] all’interno di una funzione particolare 
chiamata init (). 

Ecco come appare il codice: 


class Player: 

def init (self) : 

self. dice = [] 

La funzione init () viene eseguita ogni volta 

che utilizzi una classe per creare un oggetto. 

Questa funzione è nota come ‘costruttore’ o 
‘istanziatore’. 

Quando useremo questa classe Player per creare gli 

oggetti giocatore, il codice init () verrà 

eseguito ogni volta. 


print("Lancio Giocatore 1" + str(playerl_dice) ) 
print("Lancio Giocatore 2" + str(player2_dice) ) 

if sum(playerl_dice) == sum(player2_dice) : 

print ("Pari" ) 

elif sum(playerl_dice) > sum(player2_dice) : 

print ("Vince il Giocatore 1") 
else: 

print ("Vince il Giocatore 2") 


bunco-oop.py 

from random import randint 

class Player: 

def init_ (self): 

self. dice = [] 

def roll(self): 

self. dice = [] # clears current dice 
for i in range(3) : 

self .dice. append( randint (1,6) ) 

def get_dice(self ) : 

return self. dice 


playerl = PlayerQ 
player2 = PlayerQ 

playerl. rollQ 
player2. rol () 

print("Lancio Giocatore 1" + str(playerl.get_dice())) 
print("Lancio Giocatore 2" + str(player2.get_dice())) 

if sum(playerl.get_dice( ) ) == sun (player2. get_dice( ) ) : 
print( "Pari ! ) 

elif sum(playerl.get_dice() ) > sum(player2.get_dice() ) : 

print("Vince il Giocatore 1!") 
else : 

print("Vince il Giocatore 2!") 
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La funzione crea un set di dadi separato per ciascuno dei 
nostri giocatori. 

Anche la parte ‘self’ ha bisogno di essere spiegata. Le 
variabili, come la nostra dice = [] generalmente sono 
disponibili (o vengono restituite) quando una funzione 
termina. 

Quindi se mettiamo dice = [], la lista verrà creata da 
init (), scomparendo subito dopo. 

Python risolve questo problema con la parola chiave 
‘self’ che devi inserire dentro le parentesi della funzione 

init (): 


def init (self) 

Poi useremo self, seguito da un punto, per 
memorizzare la variabile in questa versione 
delPoggetto 

self. dice = [] 

Poi userai self. alPinterno delle funzioni, scrivendolo 
tra le parentesi, quando vorrai accedere alle variabili o 
cambiarle. In questo modo: 

def roll(self): 

Il concetto può risultare incomprensibile (passare 
una versione di se stesso dentro di se). Quindi 
focalizziamoci sul lato pratico invece che sulla teoria 
esoterica di come può funzionare: 

• All’inizio di una classe metti la funzione speciale 

init (self). 


Le funzioni degli oggetti si chiamano ‘metodi’, ma 
sono create nello stesso modo. 

Ci sono parecchi tipi di metodo, puoi creare quelli 
che vuoi, ma i più comuni sono quelli chiamati ‘setter’ 
e ‘getter’. 

Il nostro metodo roll è un ‘setter’. Imposta la lista 
dice usando tre numeri casuali. 

Cosa pensi che faccia un ‘getter’? Esattamente, legge 
il contenuto delle variabili di un oggetto e le 
restituisce. 

Ecco qui il nostro getter: 

def get_dice(self ) : 
return self. dice 

I getter ed i setter all’inizio sembrano piuttosto 
strani. Dopo tutto puoi sempre recuperare l’oggetto 
per accedere alle variabili. 

Almeno in Python questo è possibile, ma questa è 
considerata una cosa sbagliata. Uno dei cardini della 
OOP è che un oggetto contiene le sue variabili e le 
mantiene al sicuro dagli altri oggetti. Quindi non puoi 
semplicemente accedere ad un oggetto per leggerne le 
variabili. 

Invece, crei dei metodi (funzioni) che settano le 
variabili o le leggono. Poi utilizzi questi metodi per 
settarie e leggerle. 

Adesso che abbiamo creato la nostra definizione di 
classe, possiamo usarla per creare gli oggetti. 


Creare lontano 


• Metti le variabili che vuoi usare dentro init. 

• Crea le variabili usando self., come self .name 
oself.age o self. dice = []. 

• Inserisci self nelle parentesi delle funzioni che 
hanno bisogno di accedere alle variabili. 

• Usa self, ed il nome della variabile per usarla 
dentro la funzione . 

Ci siamo? Non preoccuparti se ti sembra strano, è la 
parte più difficile è sarà più facile con la pratica. 

Adesso che abbiamo la nostra lista dei dadi, come 
facciamo con le altre funzioni? 


Metodi tra la follia 


Adesso che la nostra classe ha una lista per i 
dadi, abbiamo bisogno di lanciarli e per farlo 
definiremo una funzione più comune. 

def roll(self): 

dice = [] # azzera il valore di dice 
for i in range(3): 

self .dice. append(randint( 1,6)) 


Gli oggetti si creano esattamente come le variabili. 
Uso l’operatore di assegnazione (=). Adesso creiamo 
due giocatori che lanciano i dadi. 

playerl = Player () 
player2 = Player () 

Nota bene che playerl e playen non vengono 
chiamate ‘variabili’, ma ‘istanze dell’oggetto 1 . 

Accediamo ai metodi di un istanza di oggetto usando 
la notazione puntata, la sintassi in cui utilizzi il nome 
dell’istanza dell’oggetto seguita da un punto, seguito 
a sua volta dal nome del metodo che vorresti 
utilizzare. 

Abbiamo creato un metodo, get_dice(), che 
restituisce il valore dei dadi memorizzato. Per 
accedere a questo metodo con la notazione puntata 
scriveremo playen.get_dice(). 

Come prima cosa utilizziamo il metodo roll in modo 
che ciascun giocatore lanci i suoi dadi: 

playerl. roll() 
player2. roll() 

Il resto del nostro programma bunco_oop.py è 
davvero molto simile al file bunco_proceduralpy. 

La differenza è che qui utilizziamo il metodo 

.get_dice() al posto di sum(). 
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Imbroglioni ereditari 


Abbiamo già detto che uno dei vantaggi della OOP è la 
possibilità di creare centinaia di migliaia di giocatori 
con il loro set di variabili. 

C’è una cosa che merita attenzione nel nostro 
programma, tutti i giocatori utilizzano gli stessi dadi 
ed hanno le stesse possibilità di vittoria. Ma cosa 
succederebbe se introducessimo dei bari? 

Creiamo un imbroglione che gira uno dei dadi per 
ottenere un sei. Il tizio. 

Il nostro imbroglione non è solo, ma ce n’è un altro 
che usa tre dadi truccati, che vincono sempre di un 
punto (a meno che non abbiano già dato sei). 

Entrambi gli imbroglioni batterebbero un giocatore 
normale giocando poche centinaia di partite, ma quale 
degli imbroglioni batterebbe l’altro? 

Non è così difficile trovare la risposta alla domanda, 
dobbiamo semplicemente simulare alcune centinaia 
di migliaia di partite. 

Creeremo i nostri imbroglioni utilizzando una 
tecnica che si chiama ereditarietà. Si tratta della 
tecnica utilizzata per creare una classe che prenda le 

Ma quale trucco 
avrebbe vinto, 
contro l'altro? 

caratteristiche (variabili di istanza e metodi) di 
un'altra, e ne aggiunge altre sue specifiche. 

Pensa ad un bambino che eredita le caratteristiche 
dai propri genitori. Potrebbe avere il grande naso del 
padre ma crescere con le ginocchia bitorzolute, 
dovute tutte solo a lui. 

I nostri imbroglioni ereditano le stesse funzioni dice 
e roll del ‘parent’ (classe padre), ma possiedono 
anche delle funzioni specifiche per imbrogliare. 

Nel nostro programma bunco_module.py è definita 
la classe PlayerQ ed i due figli: 


bunco-module.py 

from random import randint 

class Player: 

def init_ (self): 

self. dice = [] 

def roll(self): 

self. dice = [] # azzera i punteggi correnti 
for i in range(3) : 

self .dice. append( randint (1,6) ) 

def get_dice(self ) : 

return self. dice 

class Cheat_Swapper(Player) : 
def cheat(self): 
self .dice[-l] = 6 

class Cheat_Loaded_Dice(Player) : 
def cheat(self): 
i = 0 

while i < len(self .dice) : 
if self.dice[i] < 6: 

self.dice[i] += 1 
i += 1 


buncajùngle-teót.p y, 

from buncojnodule import Player 

from buncojnodule import Cheat_Swapper 

from buncojnodule import Cheat_Loaded_Dice 

cheaterl = Cheat_Swapper( ) 
cheater2 = Cheat_Loaded_Dice() 

cheaterl. roll() 
cheater2. roll( ) 


u 


il 


class Player: 

class Cheat_Swapper(Player) : 

class Cheat_Loaded_Dice(Player) : 

Gli oggetti che ereditano dal padre sono definiti 
usando lo stesso nome di classe. 

Però in questo caso il nome della classe padre viene 
inserito tra le parentesi del figlio. 

I nostri due imbroglioni ereditano tutte le variabili ed 
i metodi dal padre, quindi hanno già un lista dice ed i 
metodi roll() e get_dice(). 

Adesso aggiungiamo a ciascuno di essi un nuovo 
metodo, che chiameremo cheat, implementato in 
maniera diversa per ciascun tipo di trucco. 


cheaterl. cheatQ 
cheater2.cheat() 

print("Lancio imbroglione 1 
print("Lancio imbroglione 2 

if sum(cheaterl.get_dice() ) 
print("Pari! ) 


+ str(cheaterl.get_dice() ) ) 
+ str(cheater2.get_dice() ) ) 

== sum(cheater2.get_dice() ) : 


elif sum(cheaterl.get_dice()) > sum(cheater2.get_dice() ) : 
print("Vince imbroglione 1!") 

else: 


print("Vince imbroglione 2!") 
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La definizione della classe Cheat_Swapper 
contiene un metodo per barare piuttosto 
semplice: 

class Cheat_Swapper(Player) : 
def cheat(self): 
self dice[-l] = 6 

Il metodo per imbrogliare della classe 
Cheat_Swapper cerca l’ultimo elemento nella lista 
dice e lo imposta a 6. 

La classe Cheat_Loader_Dice ha un metodo un po 
più complesso: 

class Cheat_Loaded_Dice(Player) : 
def cheat(self): 
i = 0 

while i < len(self .dice) : 
if self.dice[i] < 6: 

self.dice[i] +=1 
i +=l 

Questo metodo scorre i dadi presenti nella lista 
controllando se il risultato è minore di sei, nel qual 
caso incrementa il valore di uno. 

Assicurati di aggiungere il codice nel file 
bunco_module . py e di salvalo con lo stesso nome. 


Osserva questo codice, alla fine non ha traccia di 
programmazione procedurale. Il motivo è che lo 
importeremo (in questo modo vedrai cosa accade 
quando usi import nei tuoi programmi in Python). 

Adesso creeremo il codice che utilizza questi oggetti 
in un file separato. Inserisci il codice dal listato 
bunco_single_test.py ed assicurati di salvarlo 
nella stessa cartella in cui si trova bunco_module . py. 

La prima riga importa la definizione della classe 
Player dal nostro file bunco_module.py. 


from bunco_module import Player 

ìooo punti se ti sei accorto che bunco_module è 
richiamato senza l’estensione ( .ppy’. Questo è come 
puoi importare nel tuo programma del codice 
contenuto in altri file. 

La riga import Player incolla il codice della 
definizione Class Player dal file bunco_module . py , 
ed equivale ad includere il codice nel tuo programma. 

Se confronti questa riga con l’istruzione from 
random import randint, che si trova nel file 
bunco_module . py scoprirai che il principio alla base è 
lo stesso. 

Importiamo anche le altre due definizioni di classe 
che abbiamo creato: 
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COMPRENDERE LA PROGRAMMAZIONE ORIENTATA AGLI OGGETTI 


bunco-Aimulatwn.pu 

from bunco_module import Cheat_Swapper " ** 

from buncojnodule import Cheat_Loaded_Dice from bunco_module import * 


Il codice contenuto in bunco_single_test .py crea lo 
stesso gioco presente nel file bunco_oop. py di prima. 

Adesso creeremo due istanze oggetto utilizzando le 
classi Cheat_Swapper e Cheat_loaded_Dice 
importate da buncojnodule: 


swapper = Cheat_Swapper( ) 
loaded_dice = Cheat_Loaded_Dice() 


swapper_score = 0 
loaded dice score = 0 


cheaterl = Cheat_Swapper() 
cheaterl = Cheat_Loaded_Dice() 


number_of_games = 100000 
game_number = 0 


Poi useremo il metodo roll( ) , da notare che né 
Cheat_Swapper() né Cheat_Loaded_Dice() 

hanno definito il metodo roll. Poiché ereditano 
questa funzione dalla classe padre, PlayerQ: 


cheaterl. roll() 
cheater2. roll() 

Poi chiameremo il metodo cheat() per entrambi 
gli oggetti: 

cheaterl. cheat() 
cheater2.cheat() 


print( "Simulazione in corso") 
print( "==================" ) 

while game_number < number_of_games : 
swapper . roll ( ) 
loaded_dice. rol () 

swapper . cheat( ) 
loaded_dice. cheat( ) 

#Rimuovi il # prima delle istruzioni print per attivare la 
#Simulazione. Impiegherà circa un'ora con le istruzioni print 
#oppure dieci secondi con le istruzioni print commentate 


Nonostante ogni oggetto abbia un metodo chiamato 
cheat, gli oggetti hanno una implementazione 
differente. Infatti cheaterl cambia l’ultimo dado in 
un 6, mentre cheater2 incrementa il valore di 
ciascun dado di 1. 

Esegui il programma premendo F5 e verifica chi 
vince. Se lo esegui un altra volta otterrai un risultato 
diverso. Continua ad eseguirlo e ti accorgerai che si 
tratta di un testa a testa. 

Se guardi nella cartella che contiene i sorgenti ti 
accorgerai che è comparso un nuovo file chiamato 
buncojnodule. pyc. Si tratta di un ‘file compilato’ che 
viene creato la prima volta che esegui un programma 
che importa del codice. Generalmente non guardi i file 
compilati perché importi del codice che è nascosto nei 
meandri di Python nel tuo computer. No ti 
preoccupare di questo, tanto si tratta di file che non 
puoi aprire in un editor di testo. Se vuoi lo puoi anche 
cancellare perché verrà ricreato quando utilizzerai il 
file buncojnodule . py nella versione finale del 
programma. Per ora lo puoi semplicemente ignorare. 

Per scoprire quale dei due imbroglioni ha la meglio 
sull’altro dobbiamo eseguire una simulazione. 
Dobbiamo giocare centinaia di migliaia di partite 
tenendo traccia di chi vince. 

Il programma definitivo, bunco_simulation . py, 
fa esattamente questo. Questo programma mette 
insieme tutto quello che abbiamo imparato sulla OOP. 
Il codice contenuto nel file bunco_simulation . py 
crea due imbroglioni e gioca 100.000 partite. Importa 
le definizioni di classe dal nostro programma 
buncojnodule. py (quindi assicurati di averlo salvato 
nella stessa cartella). 


#prrnt( "Cheater 1 rolled" + str(swapper. get_dice( ) ) ) 

#pnint( "Cheater 2 rolled" + str(loaded_dice.get_dice())) 

if sum(swapper.get_dice()) == sum(loaded_dice.get_dice() ) : 
#print( "Pari ! ") 
pass 

elif sum(swapper .get_dice() ) > surr (loaded_dice.get_dice( ) ) : 
#print( "Vince Dice Swapper!") 
swapper_score+= 1 

else: 

#print( "Vince Loaded Dice!") 
loaded_dice_score += 1 

game_number += 1 

print( "Simulazione completata" ) 

print(" ) 

print( "Punteggi finali") 
print(" ) 

print( "Swapper ha vinto: 5 + str(swapper_score) ) 
print("Loaded Dice ha vinto: " + str(loaded_dice_score) ) 

if swapper_score == loaded_dice_score: 

print("Il gioco è finito in parità") 
elif swapper_score > loaded jdice_score : 

print ("Swapper ha vinto più partite") 
else: 

print("Loaded Dice ha vinto più partite") 


raspberrypi.org/magpi Pagina tradotta da hellska perwww.raspberryitaLy.com 


Febbraio 2017 75 



